home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / pfm225.arc / PFMDOC.LST < prev   
Encoding:
File List  |  1986-08-19  |  42.5 KB  |  1,135 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                 PFM INFORMATION MANUAL version 2.25
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                 Copyright Paul R. Culley 1983, 1984, 1985, 1986
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.         PFM INFORMATION MANUAL                          PAGE 1
  64.  
  65.  
  66.                 WHAT IS PFM?
  67.  
  68.         PFM  is a personal file managment system to help you to deal  with 
  69.         DOS.  It is used to make common file maintenance chores easier and 
  70.         faster.   PFM is a "Front End" for the DOS command processor.   It 
  71.         is  a  visual directory maintenance tool with pointer  and  single 
  72.         character  menu driven interface.   It is many good  things  which 
  73.         users  have requested.   To find out more,  read the rest of  this 
  74.         manual,  or,  (If  you are like me) just start running it and  see 
  75.         what it does.
  76.  
  77.                 REQUIREMENTS FOR USE.
  78.  
  79.         *       MSDOS or PCDOS versions 2.0 or greater.
  80.         *       IBM pc's or compatible machines.
  81.         *       The IBM monochrome adapter,  EGA, or color adapter in the 
  82.         80 column text mode, or an adapter that is compatible with one of 
  83.         the  above.   (Note  that PFM.COM produces flicker with  the  IBM 
  84.         color adapter,  Compaq and other compatible's color adapters work 
  85.         properly.   If  you  have  an  IBM color  adapter  use  the  file 
  86.         IBMPFM.COM instead of PFM.COM.)  
  87.         *       PFM requires a minimum of a two disk system (or a  system 
  88.         connected  to  a  network) and is most useful with  large  (hard) 
  89.         disks.
  90.         *       128k to 640k of memory (more is better!)
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.         PFM INFORMATION MANUAL                          PAGE 2
  127.  
  128.  
  129.                 INSTALLATION
  130.  
  131.         To install PFM on your disk,  just copy it from the  distribution 
  132.         floppy  to  your disk.   If (and only if) you have an  IBM  color 
  133.         graphics adapter then copy the special IBM version of PFM to your 
  134.         disk using the standard DOS command;
  135.  
  136.         EXAMPLE:        copy a:ibmpfm.com c:pfm.com
  137.  
  138.         Otherwise,  copy  the standard version of PFM to your disk  using 
  139.         the standard DOS command;
  140.  
  141.         EXAMPLE:        copy a:pfm.com c:
  142.  
  143.         Then begin executing PFM as a command.
  144.  
  145.         EXAMPLE:        pfm
  146.  
  147.         When  PFM starts up for the first time,  it will display a signon 
  148.         message and instruct you to enter the location where PFM has been 
  149.         placed.   If  you do not want to run PFM at this time,  just  hit 
  150.         [ESC] on the keyboard to exit.   If you do,  you should enter the 
  151.         entire  pathname,  including the drive letter,  the path and  the 
  152.         filename of PFM itself.   For example;  if you placed PFM in  the 
  153.         root directory on drive C: your response would be;
  154.  
  155.                 Enter the complete new pathname of PFM:  c:\pfm.com
  156.  
  157.         Note that the cursor, [Ins], and [Del] keys work for changing the 
  158.         response.   PFM must remain in the drive where it is installed in 
  159.         order  for  correct operation of the "Help"  and  "Configuration" 
  160.         facilities.   If  you move PFM or attempt to restart it from  an-
  161.         other drive, it will ask the installation questions again.
  162.  
  163.         PFM  will then ask you if you require help,  if you enter  "Y"  a 
  164.         help  screen will appear which will remind you how to answer  the 
  165.         following  questions.   (To  exit HELP,  hit the [F10]  or  [ESC] 
  166.         keys).
  167.  
  168.         After  the  HELP question is complete,  PFM asks the name of  the 
  169.         text editor that you generally use.
  170.             The  requirements for the editor are that it be started as  a 
  171.         ".COM" or ".EXE" file,  it must accept the file to be edited as a 
  172.         command line input,  and it must be able to locate it's own over-
  173.         lays  and  help files (if any) when they are not on  the  current 
  174.         disk or in the current directory.   The DOS editor EDLIN.COM  can 
  175.         be used but there are many better ones available (such as PMATE).  
  176.         (Sadly WORDSTAR and PALANTIR versions that the author is familiar 
  177.         with will not work.)
  178.             Enter  the  name and location of your editor as  the  example 
  179.         shows. Remember to type the entire pathname including drive.
  180.  
  181.         Example:        Editor pathname: C:\DOS\EDLIN.COM
  182.  
  183.         This entry specifies the editor used by PFM when you want to edit 
  184.         a file.
  185.  
  186.  
  187.  
  188.  
  189.         PFM INFORMATION MANUAL                          PAGE 3
  190.         The  next  question  PFM asks is whether you  want  to  keep  the 
  191.         original  cursor provided by DOS when you return to DOS later on.  
  192.         Since  I  happen to like a large blinking cursor (the  better  to 
  193.         find  it on the screen) PFM will make the cursor that way  unless 
  194.         you specifically answer "Y" to this question.
  195.  
  196.         Example:        Keep original cursor? (Y/N): N
  197.  
  198.         The  next  question  PFM asks refers to the  setup  of  your  own 
  199.         special commands.  This is described in detail in a later section 
  200.         (YOUR COMMANDS).  For now, just hit the "ESC" key.
  201.  
  202.         Example:        ESC or Your command Char?  [ESC]
  203.  
  204.         The  next question PFM asks is if the above answers are  correct. 
  205.         The  answers  to all these questions and other settings  will  be 
  206.         saved with PFM if you answer "Y".   If you don't answer "Y", then 
  207.         the  answers will only last until you quit.   (You can come  back 
  208.         and change your mind later before you quit).
  209.  
  210.         PFM  will  now  begin normal operation by displaying  the  signon 
  211.         advertisement.   Hit  [F10] or [ESC] to begin operation  and  PFM 
  212.         will display the main directory and menu screen.
  213.  
  214.                 OPERATION OF PFM (MAIN MENU)
  215.  
  216.         After  PFM is installed,  it can be restarted by typing "PFM"  on 
  217.         the  DOS  command  line.   Note  that if you  start  PFM  with  a 
  218.         drive/path on the command line that PFM will begin by  displaying 
  219.         the indicated path.
  220.  
  221.         The main menu displayed by PFM consists of several sections.
  222.  
  223.             The main section of the screen in the middle to the left is a 
  224.         listing of the directory at the current drive/path.  This listing 
  225.         contains  the file names,  sizes of the files,  date and time  of 
  226.         last  write,  and the attributes of the files.   This listing  is 
  227.         sorted  in  some order (the initial order is alphabetic with  ex-
  228.         tensions given priority over names).   You can move the cursor to 
  229.         point to any entry on this screen with the cursor keys.   If  you 
  230.         get  too  close to the beginning or the  end,  the  display  will 
  231.         scroll  to show you more files in the directory (as long as there 
  232.         are some more).
  233.             On the top line of the screen is a list of commands which are 
  234.         available at the moment.  These commands are activated by hitting 
  235.         the  highlighted  letter  from each command  (usually  the  first 
  236.         letter)  on the keyboard.   If that command works in the  current 
  237.         situation, then it will do it's thing.  If not, or if the command 
  238.         key  is  not legal,  then nothing will happen,  good or bad  (No, 
  239.         bells, buzzes or error messages here!).  Many of the commands act 
  240.         on the file that the cursor is next to (pointing to) allowing you 
  241.         to do these commands on these files with only a few keystrokes.
  242.             On  the  second  line of the screen is the  pathname  of  the 
  243.         current drive and directory.
  244.             On the last line of the screen is a set of commands which are 
  245.         activated by hitting the function keys (more on this later).
  246.             On  the right side of the screen is some other  miscellaneous 
  247.         information  about the directory and disk drive and the date  and 
  248.         time.
  249.  
  250.  
  251.  
  252.         PFM INFORMATION MANUAL                          PAGE 4
  253.  
  254.                 MAIN MENU COMMANDS
  255.  
  256.         Following  are  the commands which are activated  from  the  main 
  257.         menu.  In general they will involve the file name that the cursor 
  258.         is  pointing to when the command is hit.   At this point I should 
  259.         note that if you start something that you do not want to  finish, 
  260.         just hit the [ESC] key.  This will get you back to the main menu.
  261.             Many  of the commands require some kind of typed in response.  
  262.         To make this easier,  PFM supplies an initial input or saves your 
  263.         last  input  to  the response to  save  typing.   To  edit  these 
  264.         responses see the section on LINE EDITING.
  265.  
  266.         *       Copy  - Copy  the pointed file to  somewhere.   PFM  will 
  267.         prompt you for a "destination".  This prompt may be answered with 
  268.         a  complete pathname (drive,  path,  file,  ext) or just some  of 
  269.         these. If an element is missing, then PFM will assume the current 
  270.         pathname  component  for the missing element.   You can also  use 
  271.         wildcards  ("?"  or  "*") as dos does in the  file  or  extension 
  272.         portion of the pathname.   PFM behaves much like DOS in all these 
  273.         examples.   In  the  following  examples we will  copy  the  file 
  274.         "test.123" from the current drive/directory "c:\exam\" to several 
  275.         different places;
  276.  
  277.                 a:              (to a:\xxx\test.123 if last dir
  278.                                  accessed on a: was "xxx")
  279.                 a:\             (to a:\test.123)
  280.                 \ouch           (to c:\ouch if c: does not contain
  281.                                  a dir called ouch)
  282.                 \ouch           (to c:\ouch\test.123 if c: does contain
  283.                                  a dir called ouch)
  284.                 \ouch\          (to c:\ouch\test.123)
  285.                 a:\*.           (to a:\test)
  286.                 a:\*.xyz        (to a:\test.xyz)
  287.                 a:\*            (to a:\test.123)
  288.                 ?z*.?4?         (to c:\exam\tzst.143)
  289.                 *.*             (to itself {an error})
  290.  
  291.         When  the  destination has been fully specified,  a  return  will 
  292.         cause the file to be copied.   The destination file name will  be 
  293.         displayed  on the second line of the screen and a "C" will appear 
  294.         where the cursor was in the main part of the screen.  If an error 
  295.         occurs  it  will be displayed at the top of  the  screen.   Note: 
  296.         Since copying a file to itself would erase most of the file,  PFM 
  297.         considers  this  an  error and does it's  best  to  prevent  this 
  298.         occurrence.   PFM  saves  the last several copy destinations  for 
  299.         you.   To  use them,  hit the up-arrow and/or down-arrow keys  to 
  300.         find the one you want.
  301.  
  302.         *       Delete  - Delete a pointed file or directory.   You  must 
  303.         answer  the  "Are you sure" prompt with a "Y" to actually  delete 
  304.         the file.   If a file is write protected (a "W" in the attributes 
  305.         column) then an error will occur.  In this case use the Attribute 
  306.         command to first unprotect the file.   Note that DOS will not let 
  307.         you delete a directory which contains files.  PFM doesn't either.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.         PFM INFORMATION MANUAL                          PAGE 5
  316.  
  317.  
  318.         *       Edit  - Edit  the pointed file  with  your  editor.   PFM 
  319.         starts  up  your  editor on this file name.   When you  are  done 
  320.         editing  quit the edit and PFM will restart right where  it  left 
  321.         off  (Neat Huh?) Note that Write-protected or Hidden/System files 
  322.         may not be editable by your editor.
  323.  
  324.         *       Attrib  - Change  the file attributes of the  file.   The 
  325.         attributes of a file are displayed in the main part of the screen 
  326.         as  follows:   "B"  not  backed  up,  "D"  directory,  "W"  write 
  327.         protected,  "S"  system  type,  "H"  hidden.   The  Bakup,  Write 
  328.         protect,  Hidden  and  System attributes  may  be  changed.   PFM 
  329.         prompts you with a line as follows:
  330.  
  331.                         B= W= H= S=
  332.  
  333.         To  add  an attribute,  change the "=" to a "+".   To  remove  an 
  334.         attribute change the "=" to a "-",  or use the "=" to leave it as 
  335.         it is.
  336.  
  337.         *       cOmmand  - Allows  the execution of  DOS  commands.   PFM 
  338.         prompts  for  the text of the DOS command.   A blank  entry  will 
  339.         activate  DOS until the DOS "EXIT" command is entered so that you 
  340.         can  temporarily  use  DOS as you used  to.   When  entering  the 
  341.         command string,  you can specify portions of the current (pointed 
  342.         to) pathname by entering on of the keys F1 to F4.  Use the F1 key 
  343.         for the first part of a filename,  and the F2 key for the  entire 
  344.         file  name.   If you want to include the current path or drive in 
  345.         the command string, use the F3 and/or F4 keys.  When you do this, 
  346.         strange characters will be entered on the command line which will 
  347.         later  be replaced by their corresponding pathname  parts.   When 
  348.         you complete the command,  PFM will execute it just as DOS would.  
  349.         When the command is finished running,  a message "Hit any key  to 
  350.         continue"  will appear.   When you strike a key,  the system will 
  351.         return   to  PFM.    In  the  following  examples   the   current 
  352.         drive/directory is "c:\exam\" and the file name is "test.asm";
  353.  
  354.                 type [F4][F3][F2]
  355.                         results in      "type C:\EXAM\TEST.ASM"
  356.  
  357.                 [F1]
  358.                         results in executing the command "TEST"
  359.  
  360.                 xtalk
  361.                         results in executing the command "xtalk"
  362.  
  363.                 masm [F1],[F1],[F1];
  364.                         results in      "masm TEST,TEST,TEST;"
  365.  
  366.         The  command line also has the ability to remember the last  sev-
  367.         eral commands that you have used.   To look at and use them,  use 
  368.         the cursor down arrow and/or up arrow to find the one you want.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.         PFM INFORMATION MANUAL                          PAGE 6
  379.  
  380.         *       Print  - Print the pointed file on system  printer.   The 
  381.         "lines  per page" prompt allows you to specify a page length  for 
  382.         files  which do not have form feeds imbedded.   If your  file  is 
  383.         already  paged,  specify "0".   If the file has some form  feeds, 
  384.         then  setting  the  lines per page will insure that  no  page  is 
  385.         longer than the specified amount.  If you want more than one copy 
  386.         of the item being printed,  set the number of copies parameter to 
  387.         the  appropriate number.   If you want an eight space left margin 
  388.         added to the printout,  answer 'Y' to the margin  question.   PFM 
  389.         will  show  a "PRINTING" status in the upper left corner  of  the 
  390.         screen  until printing is complete unless you hit another key  on 
  391.         the  keyboard.   If  you do,  printing halts and you are given  a 
  392.         chance to abort or continue the printout.  (Hitting the space key 
  393.         is the best way to stop printing a file).
  394.  
  395.         *       More  - Allows  operations not related to  the  displayed 
  396.         directory.  Use  to  config PFM,  edit a new  file,  make  a  new 
  397.         directory,  or  show a pathname.   See the MORE MENU section  for 
  398.         details.
  399.  
  400.         *       Rename  - Change  the name of the file or move file to  a 
  401.         different directory on the same drive.  The pathname and filename 
  402.         syntax is the same as that for the copy command.  If applied to a 
  403.         directory,  you can ONLY rename the directory, you cannot move it 
  404.         to a different place on the disk.
  405.  
  406.         *       Show  - Displays  the  contents of the  current  file  or 
  407.         directory on the screen.   If you are showing a  directory,  then 
  408.         you are also changing to that directory as the current directory.  
  409.         See the section on SHOW for more details on showing a file.
  410.  
  411.         *       Your  command - Like "O" command above,  except uses your 
  412.         preconfigured commands.   See the More Config command section for 
  413.         details on how to configure your own commands.
  414.  
  415.         *       Quit - Exit PFM and return to DOS.   You will be prompted 
  416.         with "Are you Sure".
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.         PFM INFORMATION MANUAL                          PAGE 7
  442.  
  443.  
  444.                 MAIN MEMU SPECIAL KEYS
  445.  
  446.         *       F1 - down.   This key moves the cursor (pointer) downward 
  447.         through the directory listing by 20 lines.
  448.         *       F2  - up.   This  key moves the cursor  (pointer)  upward 
  449.         through the directory listing by 20 lines.
  450.         *       F3 - down.   This key moves the pointer downward  through 
  451.         the directory listing by 10 lines.
  452.         *       F4  - up.   This key moves the pointer upward through the 
  453.         directory listing by 10 lines.
  454.         *       F5 - reread dir.   This key causes the current  directory 
  455.         to  be reread to update the screen.   This is done  automatically 
  456.         after  each  PFM command unless files are marked  (see  MULTIFILE 
  457.         operations). This can be used when a disk has been changed or you 
  458.         are finished with any marks on the screen.   If files are marked, 
  459.         you will be prompted "Are You Sure".
  460.         *       F6 - sort.   This key allows you to re-sort the directory 
  461.         listing.  See the section on SORTING for more details.
  462.         *       F7 - swap display.    PFM has the ability to keep all the 
  463.         information  about the directory that you are  currently  viewing 
  464.         (the  primary display) while showing an entirely different  drive 
  465.         or  directory  (the secondary display).   I call the  process  of 
  466.         saving  the  current display and switching to the  new  "swapping 
  467.         displays".  When you hit [F7] the first time, PFM prompts you for 
  468.         a new drive/path to display.   When this is done,  the third line 
  469.         of  the screen changes to reverse vidio to indicate that you  are 
  470.         using the secondary display. You can do anything while the secon-
  471.         dary display is shown that you can do normally.  To return to the 
  472.         primary display,  hit [F7] again.  When switching back, the orig-
  473.         inal contents are displayed unchanged.
  474.         *       F8 - in/exclude.  This key toggles the include flag on an 
  475.         individual file.  See the MULTIFILE section for more information.
  476.         *       F9  - backup  directory tree.   This shows  the  "parent" 
  477.         directory  of  the  current  directory (the  one  closer  to  the 
  478.         "root").  If  you at the "root",  this just rereads  the  current 
  479.         directory.
  480.         *       F10 - multi.   This key is used to switch between single-
  481.         file  and  multi-file mode.   See the MULTIFILE section for  more 
  482.         information.
  483.         *       ESC  - Escape  from the current operation or  backup  the 
  484.         directory tree if the menu is displayed.
  485.         *       Home  - The  Home  key  goes  to  the  beginning  of  the 
  486.         directory listing.
  487.         *       End  - The  End key moves the pointer to the end  of  the 
  488.         directory listing.
  489.         *       Up  arrow  - Use  the cursor up arrow  key  to  move  the 
  490.         pointer up by one line.
  491.         *       Down  arrow  - Use the cursor down arrow key to move  the 
  492.         pointer down by one line.
  493.         *       Pg  Up  - This  key moves  the  cursor  (pointer)  upward 
  494.         through the directory listing by 20 lines.
  495.         *       Pg  Dn  - This  key moves the cursor  (pointer)  downward 
  496.         through the directory listing by 20 lines.
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.         PFM INFORMATION MANUAL                          PAGE 8
  505.  
  506.  
  507.                 MULTIFILE OPERATIONS
  508.  
  509.         PFM has the ability to do operations on more than one file at one 
  510.         time.  This I call "multifile" operation.  Multifile operation is 
  511.         useful for many operations.   An example of this would be to copy 
  512.         a group of files to another place.  In DOS, you would use the DOS 
  513.         "copy"  command  once with a wildcard filename or  several  times 
  514.         with different file names.  If the files you want to copy are not 
  515.         easily related by a wildcard,  then typeing the individual  names 
  516.         soon gets tiresome.
  517.             In  PFM,  to copy these files,  you can simply mark the files 
  518.         you want in one of several ways and then switch to multifile mode 
  519.         and hit "C" for the copy command.
  520.             One way of marking files is with the [F8] key.  You just move 
  521.         the  cursor (pointer) to the file you want and  hit  [F8].   This 
  522.         will  put  an  asterisk "*" next to the file.   If  the  file  is 
  523.         already marked, then [F8] will remove the mark.  This can be used 
  524.         if you have only a few files or they are very different in name.
  525.             Another  way  to  mark files is with the  "Include  command".  
  526.         This command marks groups of files according your  specification.  
  527.         There  is  a  corresponding command to unmark  files  called  the 
  528.         "eXclude  command".   The excluding of files is especially useful 
  529.         if you want to copy everything except ".BAK" files,  for example.  
  530.         When  you hit "I" or "X" for the include or exclude commands  you 
  531.         will  be prompted for your choice of the method to mark  (unmark) 
  532.         the files.
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.         PFM INFORMATION MANUAL                          PAGE 9
  568.  
  569.         Following is a list of the choices to be had with the include  or 
  570.         exclude commands;
  571.         *       Before  - This choice allows you to select files before a 
  572.         specified  date/time.   If you select this choice,  you  will  be 
  573.         prompted  for the date and time.   After entering the  time,  you 
  574.         will  be  prompted for a wildcard ("?" or "*") filename to  match 
  575.         against (see below).
  576.         *       After  - This choice allows you to select files  after  a 
  577.         specified date/time in the same manner as "Before".
  578.         *       Ignore   - This   choice  allows  you  to  select   files 
  579.         regardless  of the date/time or attribute.   You will be prompted 
  580.         for  a  wildcard  ("?" or "*") filename  to  match  against  (see 
  581.         below). 
  582.         *       aTtribute  - This  choice  allows  you  to  select  files 
  583.         depending on attributes.  You will be prompted with:
  584.  
  585.                         B= W= H= S=
  586.  
  587.            A "=" indicates that the particular attribute does not matter.
  588.            A "+" requires that a file have an attribute to be selected.
  589.            A "-" requires that a file NOT have an attribute to be selected.
  590.  
  591.         After entering the attribute selection,  you will be prompted for 
  592.         a  wildcard  ("?" or "*") filename to match  against (see below). 
  593.  
  594.         *       Oldmarks  - This  choice reselects any files  which  were 
  595.         selected before the last multifile operation.   (The files marked 
  596.         with  a ".")  Use this to do multifile operations on a  group  of 
  597.         files more than once.  For example if you want to copy a group of 
  598.         files  to  another place and then delete them from  the  original 
  599.         place,  use "I", "O" for include oldmarks to remark the files for 
  600.         the delete operation.
  601.  
  602.         When  you  are  prompted for the wildcard  filename,  you  should 
  603.         follow the standard MSDOS wildcard name conventions.  If you want 
  604.         all files with the previously specified attribute,  for  example, 
  605.         use "*.*" for the wildcard.   PFM saves the last several wildcard 
  606.         filenames that you have used.   To reuse them, hit the up or down 
  607.         arrow keys to find the one you want, and hit return. 
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.         PFM INFORMATION MANUAL                          PAGE 10
  631.  
  632.  
  633.                 MULTIFILE COMMANDS
  634.  
  635.           The  following commands operate on files which have been marked 
  636.         with  the  "include" flag (an "*" in the 1st column next  to  the 
  637.         file  entry).   All of the files are done in the same  operation.  
  638.         If you wish to abort the operation, hit any key on the keboard.
  639.  
  640.         *       Copy - Copy a group of marked files to a new destination. 
  641.         The  destination  filename MUST be an incompletely  specified  or 
  642.         wildcard type name for reasonable operation.   If not,  then  you 
  643.         would  end up copying several files to the same  place,  writeing 
  644.         over each other.
  645.         *       Delete - Delete a group of marked files.  You must answer 
  646.         "Y" to the "Are You Sure" prompt.
  647.         *       Attribute  - Change  the  file attributes of  the  marked 
  648.         files. The Bakup, Write-protect, Hidden and System attributes may 
  649.         be  changed.   To  add an attribute,  use a  "+",  to  remove  an 
  650.         attribute use "-", use an "=" to leave it alone.
  651.         *       cOmmand  - Allows execution of DOS commands on the marked 
  652.         files.    Use  the  F1 and F2 keys to indicate insertion  of  the 
  653.         filename into your command.   Do not change the current directory 
  654.         or  default disk within your command without restoring it or  PFM 
  655.         will get very confused.
  656.         *       Print  - Print the marked files.   The "lines  per  page" 
  657.         prompt  allows you to specify a page size for files which do  not 
  658.         have form feeds imbedded.  If your file is already paged, specify 
  659.         "0".
  660.         *       Rename  - Change  the  name on the marked files  to  that 
  661.         specified.    The new filename MUST be a wildcard type name or  a 
  662.         new directory on the same disk.
  663.         *       Your  command  - Like "cOmmand" above,  except uses  your 
  664.         preconfigured commands.
  665.  
  666.                 MORE MENU
  667.  
  668.         These  commands  are accessed by hitting "M" on  the  main  menu.  
  669.         They are generally not related to the directory being shown.
  670.         *       Show  - This command allows selection of a new  directory 
  671.         path  and/or drive to display.   You will be prompted for the new 
  672.         path which does not require a trailing "\".
  673.         *       Config  PFM - This command allows you to setup  PFM  with 
  674.         your  own  system  configuration.   The editor PFM  uses  can  be 
  675.         changed  and  you  can also configure some of your  own  commands 
  676.         through here.   See the section on YOUR COMMANDS for more  infor-
  677.         mation on their configuration.  PFM also saves many of the "text" 
  678.         entries  which  you type while using PFM (such as  old  commands, 
  679.         copy destinations,  show file search strings, etc.)  You may want 
  680.         to  check and clean up some of these before answering 'Y' to  the 
  681.         "OK"  question  at  the end of the  config  process.   The  final 
  682.         configuration is saved on disk (in the PFM.COM file itself)  only 
  683.         when you answer 'Y' to the "OK" question. 
  684.  
  685.         continued:
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.         PFM INFORMATION MANUAL                          PAGE 11
  694.  
  695.  
  696.         *       Edit  - This  command allows you to edit a file that  you 
  697.         specify.    Enter  the file name in response to  the  `Pathname:' 
  698.         prompt.    This  is useful for creating new text files with  your 
  699.         editor.   If  you  specify a file on another drive or  path,  PFM 
  700.         changes to that directory before starting the editor.  This means 
  701.         the editor does not require an understanding of pathnames.
  702.         *       MKDIR  - This command allows the creation of a  new  sub-
  703.         directory.   The path should not be terminated by a "\".  The new 
  704.         directory will be displayed.
  705.  
  706.  
  707.                 SORTING
  708.  
  709.         The  sort  command [F6] is used to sort the directory listing  in 
  710.         some useful order.   Unless the directory is left  unsorted,  any 
  711.         subdirectories  present  in a directory are placed at the top  of 
  712.         the  display  and any files that are marked to be included  in  a 
  713.         multi-file operation are placed next.  Beyond that, the following 
  714.         orders are provided:
  715.         *       Name  - The directory listing is sorted in  alpha-numeric 
  716.         order with the filename given first priority.  That is, all files 
  717.         with the same first name will be together.
  718.         *       Extention - The directory list is sorted in alpha-numeric 
  719.         order with the file extension given first priority.  That is, all 
  720.         of the files with the same extension will be together.
  721.         *       Size  - The directory list is sorted in reverse order  of 
  722.         file size.    The largest files will appear closest to the top of 
  723.         the listing.
  724.         *       Time  - The directory list is sorted in reverse order  of 
  725.         the file date and time.   The newest files will appear closest to 
  726.         the top of the listing.
  727.         *       Don't sort - Files are left in their unsorted order  (the 
  728.         order  that they are on the disk.)  Since PFM default is to  sort 
  729.         files,  you must use [F5] to reread the directory in order to see 
  730.         the  files in the original order after you first select this sort 
  731.         method.
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.         PFM INFORMATION MANUAL                          PAGE 12
  757.  
  758.  
  759.                 SHOW FILE
  760.  
  761.         The  show  file portion of PFM is one of it's  best  features  (I 
  762.         think)  in  that  you can show any file,  regardless of  size  or 
  763.         content.   Many  files,  particularly binary or executable  ones, 
  764.         will appear as so much garbage with this utility,  but even then, 
  765.         you can still see some interesting things.
  766.             Following are a list of the commands available from the  Show 
  767.         file menu;
  768.         *       Top  - This  command  shows the  file  starting  at  the 
  769.         beginning.
  770.         *       Bottom - This command shows the end of the file.
  771.         *       Quit - This command ends Show File and returns to the PFM 
  772.         main menu.
  773.         *       +n  lines  - This  command allows you  to  move  forward 
  774.         through the file by the number of lines that you specify.  Simply 
  775.         press the + key and enter the number that you want followed by  a 
  776.         return.
  777.         *       -n  lines  - This command allows you  to  move  backward 
  778.         through the file by the number of lines that you specify.  Simply 
  779.         press  the - key and enter the number that you want followed by a 
  780.         return.
  781.         *       Variable lines - This command displays the file in  text 
  782.         mode,  that  is,  CR,  LF,  and TAB are interpreted in the  usual 
  783.         manner.  If  you select this mode,  PFM will show all  subsequent 
  784.         files in this mode.  Variable lines is the default mode.
  785.         *       Fixed lines - This command displays the file 80 chars per 
  786.         line  ignoring the meaning of the characters.   Use this mode  to 
  787.         display binary data files or files without any carriage  returns.  
  788.         If  you select this mode,  PFM will show all subsequent files  in 
  789.         this mode.
  790.         *       Showmode  - This  command allows you to change  the  way 
  791.         files are displayed.   Once you select a mode,  PFM will show all 
  792.         subsequent files in the mode.  The available modes are:
  793.  
  794.                 *  7 bit ASCII codes.  This is the default mode.
  795.                 *  8 bit IBM-PC codes.
  796.                 *  7 bit ASCII with highlight on eighth bit set and  tab 
  797.         and space filling.
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.         PFM INFORMATION MANUAL                          PAGE 13
  820.  
  821.                 SHOW FILE SPECIAL KEYS
  822.  
  823.         *       ESC - This command ends Show File and returns to the PFM 
  824.         main menu.
  825.         *       Home  - This  command  shows the file  starting  at  the 
  826.         beginning.  
  827.         *       End - This command shows the end of the file.
  828.         *       Down arrow - Moves the cursor down one line.
  829.         *       Up arrow - Moves the cursor up one line.
  830.         *       Right  arrow - Move the screen window  sideways  to  the 
  831.         right by eight columns to see long lines.
  832.         *       Left arrow - Move the screen window sideways to the left 
  833.         by 8 columns.
  834.         *       Pg Dn - Move the pointer forward through the file by  20 
  835.         lines.
  836.         *       Pg Up - Move the pointer backward through the file by 20 
  837.         lines.
  838.         *       F1  - Move  the pointer forward through the file  by  20 
  839.         lines.
  840.         *       F2  - Move the pointer backward through the file  by  20 
  841.         lines.
  842.         *       F3  - Move the screen window sideways to the left  by  8 
  843.         columns.
  844.         *       F4  - Move the screen window sideways to  the  right  by 
  845.         eight columns to see long lines.
  846.         *       F5 - Move the screen window sideways all the way to  the 
  847.         left.
  848.         *       F6  - Search  for a string in the  file.   You  will  be 
  849.         prompted  for the search string (a space matches tab  or  space).  
  850.         The cursor will stop on the line containing the string or the end 
  851.         of the file if not found.
  852.         *       F7  - Search for the last entered search  string  again.  
  853.         This can even be used to find a string in more than one file.
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.         PFM INFORMATION MANUAL                          PAGE 14
  883.  
  884.  
  885.                 YOUR COMMANDS
  886.  
  887.         PFM  allows the user to configure a set of commonly used one line 
  888.         commands as part of itself so that lazy typists (like me) can use 
  889.         a two character sequence instead of a longer command line  entry.  
  890.         To use one of these sequences,  hit "Y" from the main menu.   The 
  891.         available  commands will be displayed along the right side of the 
  892.         screen preceded by their command characters.  To select one, just 
  893.         hit the appropriate command character.
  894.                 To set up or change your own "Y" commands,  use the  "M", 
  895.         "C"  (More  Configure) commands from the main menu to get to  the 
  896.         configuration screen.   Skip through the question on your  editor 
  897.         with the return key, and answer the question on the cursor.  When 
  898.         the following line prompts,  enter a command character which will 
  899.         go with the "Y";
  900.  
  901.                         ESC or Your command Char? 
  902.  
  903.         If  you  do not want to enter or change your  own  commands,  hit 
  904.         [ESC].  Otherwise  you will then be prompted for the text of your 
  905.         command.  Enter as you would on the usual command line, including 
  906.         the  [F1] to [F4] keys.    Delete everything on the line  if  you 
  907.         want  to remove an old command.   When you are finished  entering 
  908.         the  command  hit  return.  If you have more commands  to  enter, 
  909.         repeat the process.  When you are done, you will be prompted with 
  910.         an  "OK (Y/N)?".   Your configured commands and  other  changable 
  911.         settings  will be saved with PFM if you answer "Y" to the OK?  at 
  912.         the end of the configuration.  If you don't answer "Y",  then the 
  913.         new settings will only last until you quit.
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.         PFM INFORMATION MANUAL                          PAGE 15
  946.  
  947.  
  948.                 LINE EDITING
  949.  
  950.         Whenever PFM prompts you for a response which requires more  than 
  951.         a  single character,  it allows you to use the keys on the cursor 
  952.         pad and some others to help you change the line you are entering.  
  953.         The entry fields are generally long enough for their normal  use, 
  954.         but if you try to go beyond the end, the cursor will refuse to do 
  955.         it. Following are the keys and what they do:
  956.  
  957.         *       Right  arrow - move the cursor to the right  nondestruc-
  958.         tively until the end of the current entry is reached.
  959.         *       ctrl Right arrow - move the cursor to the next "word"  to 
  960.         the right or the end of the line if this is the last word.
  961.         *       Left arrow - move the cursor to the left nondestructively 
  962.         until the beginning of the entry is reached.
  963.         *       ctrl Left arrow - move the cursor to the beginning of the 
  964.         previous word or the beginning of the entry if appropriate.
  965.         *       Backspace  - delete  the character to the  left  of  the 
  966.         cursor.
  967.         *       Del - delete the character under the cursor.
  968.         *       Ins  - go into insert mode until a special character  is 
  969.         entered.   Characters  are  inserted before  the  current  cursor 
  970.         location.
  971.         *       Tab right - move the cursor to the end of the entry.
  972.         *       Tab left - move the cursor to the beginning of the entry.
  973.         *       Home - move the cursor to the beginning of the entry.
  974.         *       End - move the cursor to the end of the entry.
  975.         *       Ctrl End - delete from the cursor to the end of the line.
  976.         *       Ctrl  Return - delete from the cursor to the end of  the 
  977.         line and return.
  978.         *       Return - take the current entry as it is.   (return  does 
  979.         not need to be at the end of the line).
  980.         *       Esc - Ignore the current entry and exit from command.
  981.         *       Up arrow -  For those prompts which  "remember" your last 
  982.         several entries, this goes through them in order of age.
  983.         *       Down arrow - Like the Up arrow  above,  except that  your 
  984.         next newest entry is displayed.
  985.         *       Ctrl Home - For those prompts which  "remember" your last 
  986.         several  entries,  this will remove all of the remembered entries 
  987.         (usually used before configuring to "clean house").
  988.  
  989.         The keys [F1] to [F4] will put special characters into the  entry 
  990.         which  will  only be meaningful in "cOmmands".   At other  times, 
  991.         they  may  cause  strange errors.   Other special  keys  will  be 
  992.         ignored.
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.         PFM INFORMATION MANUAL                          PAGE 16
  1009.  
  1010.  
  1011.                 ERRORS
  1012.  
  1013.         PFM  tries  to make error handling as easy as  possible.   If  an 
  1014.         error occurrs during normal operation which DOS would let you fix 
  1015.         and  retry,  PFM also lets you fix and retry or  abort.   If  the 
  1016.         error  is such that a retry is not reasonable,  an error code  is 
  1017.         displayed  and  you are given a chance to look at the error  help 
  1018.         list or just to return to the menu.   Following is a list of  the 
  1019.         error codes that you might get and what they might mean.   If you 
  1020.         get a code that is not in the list,  then try looking up the code 
  1021.         in your DOS manual (you may have a different DOS than I do).
  1022.  
  1023.                 1 - DOS invalid function.  This shouldn't happen, contact 
  1024.         program support.
  1025.                 2 - File not found.  The disk has been changed or perhaps 
  1026.         the editor is not present where it was configured to be.
  1027.                 3 - Path not found.   Possibly invalid syntax,  remember, 
  1028.         no trailing "\" on "More MKDIR" command.
  1029.                 4 - DOS error,  too many files open.  See your DOS manual 
  1030.         on system configuration. (CONFIG.SYS)
  1031.                 5 - Access Denied or protection violation.   This usually 
  1032.         means you are trying to write or delete a "write-protected" file. 
  1033.         Use  the "Attribute" command to unprotect the file.
  1034.                 6  - DOS  error,  Invalid file  handle.   This  shouldn't 
  1035.         happen, contact program support.
  1036.                 7   - DOS   error,   Memory  control  blocks   destroyed.  
  1037.         Something has gone very wrong, you had better reboot.
  1038.                 8  - DOS  error,  Insufficent memory  for  program.   The 
  1039.         program  might work if you "Quit" PFM first to open up some  more 
  1040.         memory and then run in the old fashioned DOS way.
  1041.                 10 - DOS error,  Invalid environment.  Something has gone 
  1042.         very wrong, you had better reboot.
  1043.                 11 - DOS error, Invalid format.  Who Knows???
  1044.                 12 - DOS error, Invalid Access code.  Who Knows???
  1045.                 13 - DOS error, Invalid Data.  Who Knows???
  1046.                 15  - Invalid  Drive  number  specified.    You  probably 
  1047.         specified a drive letter higher than you should have.
  1048.                 16 - Cannot delete the current directory.   If you really 
  1049.         want to,  first delete all the files and other directories in  it 
  1050.         first.
  1051.                 17 - Cannot rename from one device to another.   The only 
  1052.         way to do this is to copy to the other device and then delete the 
  1053.         original.
  1054.                 18 - No more files available in the directory.  That just 
  1055.         about says it all.
  1056.                 19  - No more room on the disk.   That just about says it 
  1057.         all.
  1058.                 21  - Incorrect syntax in operator  entry.   PFM  doesn't 
  1059.         like  the syntax of the Date/time entry or maybe of an  attribute 
  1060.         spec.
  1061.                 22  - Cannot  copy a file to itself.   Since  this  would 
  1062.         generally destroy the file, PFM will not let you do this.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.         PFM INFORMATION MANUAL                          PAGE 17
  1072.  
  1073.                 23 - Cannot show an empty file.
  1074.                 24  - Cannot  load a permanent memory resident task  from 
  1075.         PFM. Some programs (like PFM) leave parts of themselves in memory 
  1076.         all the time after they are loaded.   An example is the DOS PRINT 
  1077.         utility.  Since PFM uses memory in a simple minded way,  programs 
  1078.         such as these can not be run from PFM.   Sometimes programs  such 
  1079.         as the PRINT utility can be loaded once before starting PFM (like 
  1080.         in an AUTOEXEC.BAT) and will then run normally when called by PFM 
  1081.         afterwords.
  1082.                 I5  - Operator abort of a disk error operation.   If  you 
  1083.         get  a  disk error and specify the "abort" or  "ignore"  choices, 
  1084.         then  you will also get this error message.   Just hit the  [Esc] 
  1085.         key and keep going.
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.         PFM INFORMATION MANUAL                          PAGE 18
  1135.